home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 001-025 / scopedisk15 / qrt / qrtscript / readme < prev    next >
Text File  |  1995-03-18  |  5KB  |  116 lines
  1.  
  2.  QRT is a GREAT program, but needs  some  way around all of the typing and
  3.  formatting necessary  to  produce  (readable)  script  files  for  it.  I
  4.  decided rather than waste hours and  hours  typing in the scripts, that I
  5.  could write a program that would  take  care of creating the script files
  6.  as well as taking care of a few other details.
  7.  
  8.  This program basically just  asks  for  each  parameter  as you define an
  9.  object.  It then creates the script  file  (fully-formatted)  for you.  A
  10.  couple of extra things that it does  is,  remember various items that may
  11.  be duplicated (like location of a vertex),  and provide defaults for most
  12.  items.
  13.  
  14.  I also provided a 'Ground' object,  which  is  just a LARGE parallelogram
  15.  that you only need to provide minimal info in defining.  The ground is at
  16.  (Y=0), which is logical.
  17.  
  18.  A script that had twenty objects in it  could take 30 minutes to type in.
  19.  (Even longer if you format if  completely)   I dare to say that with this
  20.  program, the same twenty  objects  can  be  entered into a script in less
  21.  than five.
  22.  
  23.  For those  already  familiar  with  QRT  and  those  that  should be (ie.
  24.  everybody else):
  25.  
  26.  The location for an object  is  stored,  so  that the next object that is
  27.  created can use the same  location  by  just  pressing  return.  (This is
  28.  ideal for prisms and the like, since one vertex location can define three
  29.  sides.)
  30.  
  31.  The variables entered for radius  and  the coefficients for the quadratic
  32.  function are all remembered.   I  did  this,  since  you  may be creating
  33.  duplicate spheres, ellipses, cylinders,  oblate spheroids, etc; and don't
  34.  want to type in that info every time.
  35.  
  36.  The color for the last object is  remembered  (ie. the diff coefficient),
  37.  in case you are  creating  many  similarly  colored  objects.   The other
  38.  values have some default associated with them, so that (if you don't want
  39.  to use any special characteristics) you  can just press return and accept
  40.  the defaults.  Remember that this program creates a text file, so you can
  41.  always edit what  you  enter,  so  that  you  can  use  bounding boxes or
  42.  instances to get even more out of the program.
  43.  
  44.  List of characteristics:
  45.  
  46.  Location is remembered from the last object entered.
  47.  
  48.  V1 & V2 default to "0.0" if  you  only  press  return.   I did this since
  49.  usually one or more of the (x,y,z) triples will be zero anyway.
  50.  
  51.  Ambience defaults to  0.2,  since  this  is  a  good  value for realistic
  52.  shadowing.
  53.  
  54.  Diffusion (object color) is  remembered  from the last object, so that if
  55.  you create 4 maroon spheres, you won't have to remember to type in (0.63,
  56.  0.0,0.74) for each of the spheres.
  57.  
  58.  Mirroring defaults to none in each of r,g,b.
  59.  
  60.  Index of refraction  defaults  to  120.   This  is  good for most 'solid'
  61.  objects that aren't glassy.
  62.  
  63.  Dithering defaults to 3.  (This was  suggested  as  a good default by the
  64.  author or QRT.)
  65.  
  66.  SReflect defaults to  20.   (This  is  probably  a  little  high for most
  67.  'normal' objects, but you can  always  type in your own values instead of
  68.  accepting the defaults, so the point is moot.)
  69.  
  70.  Reflect defaults to 0.2, which is again a little high.
  71.  
  72.  Radius, Location, Color  and  Quad(A,B,C,D,XMax,XMin,YMax,YMin,ZMax,ZMin)
  73.  default to the last entered value for that parameter.
  74.  
  75.  FILE_NAME is entered as QRTScript.RAW, but can be changed externally.
  76.  
  77.  NOTE:  When you first load  up  the  program,  you  will  look at a blank
  78.  screen.   :)
  79.  
  80.  REAL NOTE:  You can choose 'NEW' from the project menu, to enter the name
  81.  of the script file that the program creates.  This file is opened, and is
  82.  continuously being written to  (buffered,  of course), so you should exit
  83.  the program with  the  'DONE'  option.   If  NO  FILE was opened when you
  84.  select one of the object or world menu options, then the program will ask
  85.  you for the name of the script file at that time.
  86.  
  87.  Be sure and LOOK at the scripts this program  creates.  The formatting is
  88.  very nice.  You don't actually have to look, since the files created with
  89.  this program are  complete  and  ready  to  use,  unless  you want to add
  90.  bounding boxes or instances.
  91.  
  92.  There are some future enhancements to this program, so tell me if there's
  93.  something in particular that you  would  like in the program.  (Besides a
  94.  graphical editor...that's a separate program.)    :)
  95.  
  96.  Send any comments or blank disks or (heaven forbid) bug reports to:
  97.  
  98.                             James A. Alexander
  99.                            4901 E. Sunrise #1014
  100.                              Tucson, AZ 85718
  101.  
  102.                        (Yes, the weather's nice...)
  103.  
  104.                               PLink: Modula*2
  105.                              CIS: Yeah, right.
  106.                                                  
  107.                                                  
  108.                                                  
  109.                                                  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.